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VB-lO/c INTERACTIVE GRAPHICS TERMINAL 



The VB-IO/C graphics terminal is a highly interactive display 
system for the PDP-10. The VB-10/c system was designed to 
allow complete user freedom and flexibility under normal PDP-10 
time-sharing. The basic hardware system consists of a 340/C 
display connected directly to PDP-10 memory through a special 
memory channel. Several important features included in the VB-IO/C 
display are memory protection and relocation, slave mode operation, 
raster mode, and subroutining. To allow complete user-display 
interaction the VB-IO/G graphics terminal has a function box, and 
a Tablet as options. Light Pen is standard, however, the important 
feature of the VB-IO/C system is the extensive software package* 
available from DECUS to control the display. This package permits 
a user not familiar with the displays hardware instructions to write 
display programs in a higher level language (FORTRAN or LISP). 

The VB-IO/C software package contains all of the basic routines 
for displaying vectors, points, and text, and for controlling the 
scale and intensity of the picture. The user can define his own 
number space or sets of number spaces and the viewpoints on the 
display where the pictures are to be displayed. Pictures can be 
generated as a set of subpictures or nested subpictures. Any part 
of a picture which falls outside of the user's number space or 
window will not be displayed. Subpictures and pictures can be 
blanked from the display and unblanked at a later time. Core 
space used by a picture can be released and refused for generating 
new pictures. The VB-IO/C package also contains all of the rou- 
tines necessary to create three-dimensional pictures. The user 
can rotate the picture by changing the pitch, yaw, and roll coef- 
ficients of the picture or zoom-in or back off from a picture by 
changing the viewpoint value. 

The VB-IO/C graphics terminal provides several levels of user inter- 
action. Simple data inputs can be entered through the function box 
or the teletype. The identification of lines or points within a 
picture can be accomplished with the light pen. However, the most 
important interactive feature of the VB-lO/c terminal is that a 
user can input graphical data through the Tablet. An architect can 
draw new structures, a mathematician can input new curves, an 
eletrical engineer can add new connections during circuit design, 
all with no more difficulty than drawing on a piece of paper. The 
VB-10/t graphics terminal can solve almost all complex graphics 
requirements with hardware and software that has already been devel- 
oped and is running in production enviroments today. 

The following description of VB10/C software is followed by an 
explanation of the Tablet and its interactive capability with the 
user's program. Pictures illustrating VB10/C output are distributed 
throughout the text. 

*Developed at National Institutes of Health, Division of Computer 
Research and Technology by Harry R. Lewis 

The information herein is subject to change without notice and 
should notbe construed as a commitment by Digital Equipment Corporatioi 
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I. introduction 

fttttftttttt 

THIS DOCUMENT DESCRIBES A GRAPH I CAL LANGUAGE FOR THE PDP»10/$40 
COMPUTER DISPLAY SYSTEM, THE LANGUAGE IS IMPLEMENTED AS A SET OF 
SUBROUTINES WHICH MAY BE CALLED FROM ASSEMBLY CODE, FROM AN 
INTERPRETED L I ST-PRQCESS I NG LANGUAGE (LISP), OR FROM A COMPILED 
ALGEBRAIC LANGUAGE (FORTRAN), THESE SUBROUTINES GENERATE BINARY 
PROGRAMS FOR THE $40 DISPLAY FROM DATA SUPPLIED AS ARGUMENTS) THEY 
ALSO INCLUDE OPERATIONS TO POST, ADD* AND DELETE INFORMATION 
FROM A DISPLAY FILE, 

SEVERAL GOALS DIRECTED THE DESIGN OF THE LANGUAGE, FIRST, 

SINCE THE 340 IS A COMPUTER, A GREAT DEAL OF PATIENCE AND PROGRAMMING 
EXPERIENCE IS NEEDED TO WRITE ASSEMBLY OR ABSOLUTE CODE FOR IT) 

THE DIFFICULTIES ARE PARTICULARLY ACUTE SINCE THE 340 HAS A POOR INSTRUCTION 
SET AND NO DEBUGGING AIDS ARE AVAILABLE FOR IT, 

SECOND, THE DESIGN OF THE 340 AND THE PQP-10/340 INTERFACE 
MAKE DYNAMIC CHANGING, ADDING, AND DELETING OF DISPLAY INFORMATION A RATHER 
TRICKY PROCESS) IT IS CONVENIENT TO HAVE A LANGUAGE TO HANDLE THESE 
ANNOYING DETAILS, ' 

THIRD, EFFICIENT USE Of MEMORY SPACE IN A PROGRAM WHICH 
DYNAMICALLY CHANGES A DISPLAY FILE REQUIRES THAT THE PROGRAM WHICH 
GENERATES A NEW DISPLAY FILE MAKE UWE~OF SPACE OCCUPIED BY 
ABANDONED DISPLAY FILES, SINCE A DISPLAY FILE IS A BINARY PROGRAM, 

it cannot easily be relocated, so the garbage collection problem is 

DIFFICULT AND ANNOYING, 

FOURTH, THE FACE OF THE CRT IS OF FINITE SIZE, WHILE 
EUCLIDEAN GEOMETRICAL SPACE IS INFINITE, HENCE, THE SCOPE MUST 
ACT AS A WINDOW ON THE ACTUAL-DATA SPACE, AND THE CODE GENERATING 
PROGRAM MUST SELECT FOR DISPLAY ONLY THE INFORMATION WHICH COULD BE 
’’SEEN" THROUGH THIS WINDOW, A RELATED PROBLEM IS THAT THE SCOPE 
HAS A FIXED, DISCRETE COORDINATE SYSTEM, WHILE AN APPLICATION 
PROGRAM MAY WISH TO DEAL IN ANGSTROMS, MILES, OR SOME OTHER UNIT, 

THE CHANGE OF COORDINATES SHOULD BE IMPLICIT, 

FINALLY, THE SUBROUTINES WERE MADE COMPATIBLE WITH HIGHER-LEVEL 
LANGUAGES SO THAT THE PROCESSING POWER OF THESE HOST LANGUAGES COULD 
BE USED TO DEAL WITH THE NON-GRAPHIC ASPECTS OF THE PROGRAM, 
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Hi PICTURES 

tttttttt 

THE SASIC UNIT OF DISPLAY INFORMATION IS CALLED A "PICTURE” 

OR "FRAME.” FIVE BASIC OPERATIONS MAY BE PERFORMED ON A PICTURE! 
GENERATE, BLANK# UNBLANK, OESJROY# AND SUBPICTURE, 

GENERATE IS THE PROCESS WHICH CREATES A PICTURE, 

«*«»•»«• 

blank removes a picture from view, while keeping IT 

AVAILABLE for later use, 

UNBlaNK RESTORES a PREVIOUSLY BLANKED PICTURE* AFTER 

»»•«•«• GENERATION, A PICTURE IS AUTOMATICALLY UNBLANKED, 

DESTROY REMOVES A PICTURE FROM VIEW AND ANNIHILATES IT, 



SUBPICTURE (USED AS PART OF THE GENERATION PROCESS FOR 

ANOTHER PICTURE) MAKES A PICTURE PART OF ANOTHER 
PICTURE, SUBPICTURES CAN BE NESTED TO ANY LEVEL, 

PICTURES ARE OF TWO KINDS! TOP-LEVEL OR COMPONENT, FOR TOP- 
LEVEL PICTURES, THE BLANK AND UNBLANK OPERATIONS AFFECT THE PICTURE'S 
VISIBILITY DIRECTLY, FOR COMPONENT PICTURES, THESE OPERATIONS AFFECT 
VISIBILITY ONLY IF A PICTURE OF WHICH THE PICTURE IS A PART IS 
UNBLANKED, A FEW EXAMPLES WILL MAKE THIS CLEARER, IN EACH CASE, 

ASSUME THAT NO OTHER PICTURES EXIST, 

EXAMPLE 1, PICTURE A IS COMPONENT AND UNBLANKEDj OR COMPONENT AND 
BLANKED! OR TOP-LEVEL AND BLANKED, THEN A WILL BE INVISIBLE, 

EXAMPLE 2. PICTURE A IS TOP-LEVEL AND UNBLANKED, BICTURE B IS TOP- 
LEVEL AND A SUBPICTURE OF A, THEN IF B IS BLANKED, ONLY A WILL BE 
VISIBLE, IF B IS UNBLANKEO, A WILL BE VISIBLE AND TWO SUPERIMPOSED 
COPIES OF B WILL BE VISIBLE, THAT IS, IN THE LATTER CASE, BOTH 
A AND B WILL BE VISIBLE, BUT B WILL BE BRIGHTER THAN A, 

EXAMPLE 3, A IS TQP-LEVELI B IS A COMPONENT SUBPICTURE OF A! C IS 
A COMPONENT SUBPICTURE OF B, THEN C WILL BE VISIBLE IF AND ONLY IF 
A, B, AND C ARE ALL UNBLANKED! B WILL BE VISIBLE IF AND ONLY IF 
A AND B ARE BOTH UNBLANKEDJ AND A WILL BE VISIBLE IF AND ONLY IF 
IT IS UNBLANKED. 
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III. WINDOWS AND VIEWPORTS 

♦♦ttttttttttttttttttt 

THE USER'S DATA SPACE SHOULD BE EQUIPPED WITH A TWO- 
DIMENSIONAL cartesian coordinate SYSTEM, before GENERATING THE 
FIRST PICTURE. HE MUST SPECIFY THE PORTION OF THE PLANE WHICH WILL BE 
SHOWN ON THE SCOPE, THIS PORTION OF THE DATA PAGE IS THE WINDOW, AND 
MUST BE a RECTANGLE WHOSE EDGES ARE PARALLEL TO THE USER'S COORDINATE 

axes, no information outside the window will be shown, for example, 

IF THE USER SPECIFIES A LINE WHICH CROSSES SOME EDGE OF THE WINDOW, 

ONLY THAT PORTION OF THE LINE INSIDE THE WINDOW WILL BE SHOWN. 

THE ENTIRE SCOPE FACE NEED NOT BE USED TO SHOW A PICTURE, 

FOR EXAMPLE, IT MAY BE DESIRABLE TO SHOW FOUR PICTURES, EACH 
OCCUPYING A QUADRANT OF THE SCREEN, 'THE PORTION OF THE SCREEN INTO WHICH 
THE WINDOW WILL BE MAPPED IS CALLED THE VIEWPORT AND MUST BE A 
RECTANGLE WHOSE EDGES ARE PARALLEL TO THE FIXED CRT COORDINATE AXES. 

THE TRANSFORMATION WHICH MAPS THE ENTIRE WINDOW AREA INTO THE ENTIRE 
VIEWPORT AREA IS LINEAR! E.G., A POINT IN THE CENTER OF THE WINDOW 
WILL BE MAPPED INJO A POINT IN THE CENTER OF THE VIEWPORT, 

THE WINDOW AND VIEWPORT MAY BE CHANGED DURING THE GENERATION 
PROCESS FOR A PICTURE OR BETWEEN PICTURES, 
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IV, A NOTE ON DATA TYPES 

tttttttttfttttttfftt 

MOST SUBROUTINE ARGUMENTS MAY BE EITHER FIXED OR FLOATING 
POINT NUMBERS! ThE SUBROUTINES WILL CORRECT EACH TYPE TO THE OTHER 
WHEN NECESSARY FOR ThEIR OWN INTERNAL PURPOSES, ThE ONLY EXCEPTIONS 
ARE! IN LISP* THt NAMES OF PICTURES MUST BE ATOMS! AND IN FORTRAN, 

THE NAMES OF PICTURES AND THE DISPLAY FILE MUST BE ARRAYS {OF ANY TYPE), 



Here we see a roadway lined with telephone poles. 
Because the observer is traveling at a rate which 
is a significant fraction of the speed of light, 
the poles appear to be bent. The observer's eye 
is at street level . 




V, INITIALIZATION 

(FOR LOADING PROCEDURES, SEE SECTION XVIII,) 

V.l FORTRAN INITIALIZATION PROCEDURE 

IN FORTRAN, INITIALIZATION REQUIRES THAT FOUR TYPES OF STATEMENTS 
BE PRESENT IN THE PROGRAM, 

V.1,1. AN ARRAY OF SUFFICIENT SIZE TO HOLD THE DISPLAY FILE MUST BE 
DIMENSIONED, REFER TO V,3 TO ESTIMATE THE REQUIRED SIZE, 

V.l, 2. an ARRAY MUST be DIMENSIONED FOR EACH PICTURE TO BE GENERATED, 

THE LENGTH OF AN ARRAY MUST BE AT LEAST THE LARGER OF 3 AND N/2 WHERE 
N IS THE NUMBER OF SUBPICTURE REFERENCES TO THE PICTURE, HERE N/2 
IS ROUNDED UP (I,E, CN/23*1 FOR N ODD, N/2 FOR N EVEN), THE NAME OF 
tHE ARRAY IS THE NAME BY WHICH THE PICTURE WILL BE REFERRED TO, THESE 
ARRAYS MAY NOT BE USED FOR ANY OTHER PURPOSE, 

V.l, 3. BEFORE CALLING ANY OTHER DISPLAY ROUTINES, THE PROGRAM MUST CALL 
0 ISP I N I (ARRAY, LENGTH) WHERE "ARRAY” IS THE NAME OF THE ARRAY REFERREO TO 
IN V.1,1 AND "LENGTH" IS ITS SIZE IN WORDS, THIS ROUTINE SHOULD 

NOT be called again; it completely initializes the display file, 

V , 1 i 4 , BEFORE GENERATING a PICTURE, THE PROGRAM MUST CALL 
0CLPIC(NAME, LENGTH), WHERE "NAME" IS THE NAME OF THE PICTURE ARRAY AS 
DESCRIBED IN V.1,2 AND "LENGTH" IS ITS SIZE IN WORDS, THIS ROUTINE 
SHOULD BE CALLED ONLY ONCE FOR EACH PICTURE) JT NEED NOT BE CALLEO 
AGAIN IF A PICTURE IS DESTROYED AND REGENERATED, 



V . 2 LISP INITIALIZATION PROCEDURE 

BEFORE CALLING ANY OTHER DISPLAY ROUTINE, THE PROGRAM SHOULD CALL 
CDJSPINIT), THIS CALL SHOULD NOT BE REPEATED, 



V.3 ESTIMATING SPACE FOR THE DISPLAY FILE 

WHEN USED WITH LISP, THE DISPLAY ROUTINES TAKE MEMORY SPACE 
FOR THE DISPLAY FILE FROM BINARY PROGRAM SPACE, SO THE USER MUST LEAVE 
SUFFICIENT ROOM AT LOAD AND ALLOC TIME, WITH FORTRAN, ROOM MUST 
BE ALLOCATED BY A DIMENSION STATEMENT AND A CALL TO DSP I N I , TO 
ESTIMATE THE NEEDED ROOM, ALLOW 

1 WORD FOR EACH POINT ( PGEN ) 

1 WORD FOR EACH 2 SHORT VECTORS ( VGEN) 

1 WORD FUR EACH 6 CHARACTERS 

1 WORD FOR EACH 5 RASTER POINTS FOR RASTER MODE DISPLAY 

1 WORD FOR EACH TOP-LEVEL PICTURE 

AND ABOUT 10* OF THE ABOVE TOTAL FOR OVERHEAD, 




VI, SETTING THE WINDOW AND VIEWPORT 

FORTRAN) CALL SETWIN (XMlN. XMAX, YMIN, YMAX) 

CALL SETPOR (XMlN, XMAX. YMIN, YMAX) 

L I SP | (SETWIN XMJN XMAX YM J N YMAX ) 

( SETPOR XMIN XMAX YM I N YMAX) 

THE FOUR ARGUMENTS REFER RESPECTIVELY TO THE COORDINATES 
OF THE LEFT, RIGHT, BOTTOM, AND TOP EDGES OF THE RECTANGLE. IN ALL 
CASES'. "XMIN” MUST BE STRICTLY LESS THAN "XMAX" AND ” Y M I N ” STRICTLY 

less than "ymax. m the window coordinates may be in any numerical range) 

the VIEWPORT COORDINATES must BE BETWEEN 0 AND 1023 DECIMAL. 

INCLUSIVE. 



This graph was plotted by a rather interesting 
demonstration program. The user need only specify 
the range of X and Y, the degree of the equation 
to be plotted, and the coefficient of the terms. 
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VII, PICTURE GENERATION 

tttttttftttf 

THIS IS THE PROCESS WHICH CREATES A PICTURE, A PICTURE WHICH 
HAS BEEN GENERATED CANNOT BE GENERATED AGAIN UNTIL IT HAS BEEN DESTROYED, 

A SECOND PICTURE CANNOT BE GENERATED DURING THE GENERATION PROCESS FOR 
A PICTURE. AT THE END OF THE GENERATION PROCESS, THE PICTURE IS ENTERED 
AS A TOP-LEVEL PICTURE IN THE DISPLAY FILE AND UNBLANKED, 

VII. X FORTRAN GENERATION 

THE GENERATION PROCESS IS BEGUN BY 
CALL GENINI (PJCNAME) 

WHERE "PICNAME" IS THE NAME OF AN ARRAY OF THE TYPE DESCRIBED IN V,X,2, 

THE PROCESS IS TERMINATED BY 

CALL GENEND (PJCNAME), 

BETWEEN THESE CALLS ARE THE COQE-GENERAT JNG STATEMENTS WHICH DESCRIBE THE 
PICTURE, ANY NON-DISPLAY STATEMENT MAY BE EXECUTED DURING THE GENERATION PROCESS, 

VII. 2 LISP GENERATION 
a ««««»«• »«««««» 

THE GENERATION PROCESS OCCURS DURING THE EVALUATION OF A SINGLE 
S-EXPRESSIQN WHICH IS OF THE FORM 

(GENERATE X EX E2 , . . EN ) , 

HERE "X" MUST BE AN ATOM AND IS THE NAME BY WHICH THE PICTURE WILL BE 
REFERRED TO. THE "E” ARGUMENTS ARE S-EXPRESS I ONS WHICH ARE SUCCESSIVELY 
EVALUATES, SOME OF THESE S-EXPRESS IONS ARE THE CODE-GENERAT J NG STATEMENTS 
WHICH DESCRIBE THEPICTUREl OTHERS MAY BE ' S-EXPRESS I ONS WHICH DO NOT REFER 
TO DISPLAY ROUTINES, 

THE VALUE RETURNED IS "X'’, 




6 



VIII, scale and INTENSITY 

tttttttMttttttttft 

THE DISPLAY HARDWARE IS CAPABLE OF DRAWING INCREMENTAL DATA IN 
FOUR "SCALES , " 1# 2, 4, OR 8, THIS VALUE GOVERNS THE SPACING BETWEEN 
INCREMENTALLY PLCTTED~PQ J NTS IN THE DISPLAY OF LINE SEGMENTS AND 
CHARACTERS! 1 IS THE SMALLEST SCALE, IN SCALE 2 THE POINTS ARE TWICE 
AS FAR APART, ETC, FOR THE PURPOSES OF THESE DISPLAY ROUTINES, THE SCALE 
VALUE IS USED ONLY TO CONTROL'THE SPACING BETWEEN POINTS WHEN'DRAWING 
LINE SEGMENTS (NOT THEIR SIHE), BUT CHANGES BOTH THE SIZE AND POINT 
SPACING OF CHARACTERS. 

THE DISPLAY HARDWARE ALSO HAS THE FACILITY FOR DISPLAYING DATA 
AT ANY OF 8 INTENSITIES, 0-7, 0 BEING THE DIMMEST AND 7 THE BRIGHTEST, 

BOTH SCALE AND INTENSITY ARE ESTABLISHED DURING GENERATION 
BY THE PARMS ROUTINE, 

FORTRAN* CALL PARMS (SCALE, INTENSITY) 

L ISP | (FARMS SCALE INTENSITY 



The "Neutron of *Minsky" is a fascinating toy which 
moves three points with the movement of any one 
dependent on the motions of the other two. 
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IX, PLOTTING AND SETTING POINTS 

ttttttttttttttttttttttttttf 

THE POINT-GENERATING ROUTINE SETS AN IMAGINARY "BEAM" AT A 

specified position on'the data page, If that point is within 7he window 
it may be intensified# i,e,# shown; otherwise# the routine merely 
establishes a position relative to which data can be specified, 

fortran; call pgen {XiY, INTENSIFY) 

LISP; (PGEN X Y INTENSIFY) 

THE ARGUMENTS "X" AND »Y« SPECIFY THE COORDINATES OF THE POINT, THE 
"INTENSIFY" ARGUMENT SHOULD BE 0 IF THE POINT IS NOT TO BE INTENSIFIED, 
NON-HERO IF IT IS'TO BE INTENSIFIED. 
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X. PLOTTING VECTORS 

fttttttttftttttt 

A LINE SEGMENT IS SPECIFIED BY GIVING THE POSITION OF ITS END 
POINT RELATIVE TO ITS STARTING POINT, THE POSITION OF THE STARTING 
POINT IS IMPLICIT » HAVING BEEN SET UP BY A CALL TO "PGEN" OR "VGEN." 
FOR EXAMPLE, TO DRAW A LINE FROM <2, 3) TO (-4,7), ONE WOULD 
POSITION THE BEAM AT (2,3) BY A "PGEN" AND THEN DRAW A VECTOR WITH 
ARGUMENTS (-6,4), VECTORS, LIKE PQINtS, MAY BE EITHER INTENSIFIED 
OR NOT, 

FORTRANl CALL VGEN (DELTAX,DEL W, INTENSIFY) 

LlSPt (VGEN OELTAX OELTAY INTENSIFY) 

AS WITH "PGEN»" "INTENSIFY" IS NQN-2ER0 TO INTENSIFY, AND ZERO NOT TO 

intensify, 




XI, TEXT 
♦ 1 1 1 



U 



THE DISPLAY PACKAGE INCLUDES SUBROUTINES TO DISPLAY TEXT AT ANY 

OF the four sizes at arbitrary positions on'the scope, these‘routines 

ARE GOVERNED BY THE WJNOQW AND VIEWPORT PARAMETERS FOR THE PURPOSES 
or CLIPPING — TEXT WILL NOT be SHOWN OUTSIDE THE SPECIFIED VIEWPORT -- 
BUT NOT FOR SCALING -- I,E,, THE SHAPE OF' A CHAR ACTER ' W I LL NOT BE 
DIFFERENT IF THE PROPORTIONS OF THE WINDOW RECTANGLE ARE DIFFERENT FROM 
THOSE OF THE VIEWPORT RECTANGLE, SINCE THESE ROUTINES TAKE 
AOVANTAGE OF THE tEXT-FORMATT I NG CAPABILITIES OF THE HOST LANGUAGE, THEY 
MAY NOT BE USED JF THE ROUTINES ARE USED WITHOUT A HOST LANGUAGE, I.E, 

IF THEY ARE USEO ONLY WITH ASSEMBLY CODE, 

THE POSITION OF THE FIRST CHARACTER OF A STRING OF TEXT IS THE 
LAST POINT SPECIFIED DIRECTLY BY "PGEN" OR IMPLICITLY BY " V G E N , " JF 
THIS POINT IS OUTSIDE THE WINDOW, NO TEXT WILL BE SHOWN, OTHERWISE, THIS 
POINT IS USED TO DETERMINE THE POSITION OF THE "LEFT MARGIN." IN CASE OF 
A CARRIAGE RETURN, 

XI, 1 FORTRAN TEXT 

TEXT DISPLAY IS INITIATED BY 
CALL TEXTP, 

AFTER THIS CALL, ALL FORTRAN "TYPE STATEMENTS WILL CAUSE THEIR 

OUTPUT TO BE CHANNELLED TO THE DISPLAY FILE RATHER THAN TO THE TELETYPE, 

UNTIL ANOTHER GENERATING ROUTINE (PGEN, VGEN, GENEND, ETC,) IS CALLED, 

AFTER CALLING ONE OF THESE ROUTINES, THE OUTPUT OF "TYPE ,,," STATEMENTS 
WILL AGAIN APPEAR ON THE TELETYPE, 

TEXT WILL APPEAR ON THE DISPLAY EXACTLY AS IT WOULD APPEAR ON 
THE TELETYPE I FORMAT SPECIFIERS ARE INTERPRETED THE SAME WAY, CARRIAGE 
control IS RECOGNIZED, ETC, the only DIFFERENCES ARE THAT LINES TOO LONG 
TO FIT IN THE WINDOW WILL BE CLIPPED — THE PART WHICH WOULD BE OUTSIDE 
THE WINDOW WILL NOT BE SHOWN! ANO LINES WHICH WOULD APPEAR BELOW THE 
BOTTOM OF THE WINDOW WILL NOT BE SHOWN, 

XI, 2 LISP TEXT 
»«««««««« 

TEXT IS GENERATED By 
(TEXT ,,,), 

THIS ROUTINE COMPLETELY MIMICS "(PRINT ,,.)" IN THE WAY IT EVALUATES 
ITS ARGUMENTS AND FORMATS ITS OUTPUT, THE ROUTINE MAY BE USED FOR DISPLAYING 
QUOTED TEXT I I.E. " ( TEXTQ A B C>" HAS THE SAME EFFECT AS 
"(TEXT (QUOTE (A B C)))." 

THESE ROUTINES ADJUST THE LENGTH OF THE "PRINTING" LINE SO THAT NO 
TEXT WILL BE LOST OFF THE RIGHT-HAND EDGE OF THE WINDOW) BUT THEY WILL 
CLIP OFF TEXT WHICH WOULD APPEAR BELOW THE BOTTOM OF THE WINDOW, 
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XII, the light pen 

tfttttttttttt 

A LIMITED FACILITY FOR THE USE OF THE LIGHT PEN HAS BEEN PROVIDED, 
THE LIGHT PEN MUST BE "TURNED OF AND OFF" WITHIN THE DISPLAY FILE IN ORDER 
TO MAKE CERTAIN PARTS OF THE PICTURE LIGHT-PEN SENSITIVE, ITS INITIAL 
STATUS, I , E , ITS STATUS AT THE BEGINNING OF THE DISPLAY FILE, IS OFF, 

SINCE THE USER HAS NO CONTROL OVER THE ORDER JN WHICH PICTURE? ARE 
OISPLAYED, HE SHOULD SPECIFY IN EACH PICTURE THE STATUS OF THE PEN, IF 
HE USES IT AT ALL. 

DURING THE GENERATION PROCESS, THE CODE TO ENABLE THE LIGHT PEN 
WILL BE GENERATED BY 

FORTRAN? CALL LPON 

LISP? (LPON)I 

THE CODE TO TURN OFF THE LIGHT PEN BY 

FORTRAN? CALL LPOFF 

LISP? (LPOFF), 

AFTER GENERATION, THE PROGRAM CAN GET THE SCOPE COORDINATES OF 
THE POINT MOST RECENTLY "SEEN" BY THE LIGHT PEN BY CALLING THE ROUTINE 
"LPIN." IF A LIGHT PEN HIT HAS NOT YET OCCURRED WHEN THIS ROUTINE IS 
CALLED, THE ROUTINE WILL HANG AND WAIT FOR ONE BEFORE RETURNING, 

FORTRAN? CALL LPIN (I) 

WHERE I IS AN ARRAY DIMENSIONED TO LENGTH 2, 

THE ROUTINE WILL RETURN WITH 

1(1) « X COORDINATE 
1(2) * Y CORRDINATE, 

LISP? (LPIN) 

THE VALUE RETURNED IS A "CONS" PAIR P, WITH 

(CAR P) s X 
( COR P) * Y, 
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XIII, MISCELLANEOUS picture-hanqling routines 

♦tttttttttttttttttttttttttttttttftttttt 

xm. i blank, unblank, and destroy 
*************************** 

FORTRANl CALL BLANK (PIC) 

CALL UNBLANK (PIC) 

CALL DESTROY (PIC) 

LISP* (BLANK (QUOTE PIO) 

(UNBLANK (QUOTE PIO) 

(DESTROY (QUOTE PIC)> 

THESE ROUTINES PERFORM THE FUNCTIONS OF BLANKING, UNBLANKING, 
AND DESTROYING PICTURES, AS DESCRIBED In SECTION II, THEY SHOULD 
NOT BE CALLED DURING THE GENERATION PROCESS FOR A PICTURE, 

XIII. 2, SUBPICTURE 

tttt******** 

FORTRANl CALL SPICT (PtCNAME) 

LISP! (SU8PJC (QUOTE PICNAME)) 

WHEN CALLED DURING THE GENERATION PROCESS FOR A PICTURE. THIS 
ROUTINE MAKES THE PICTURE ’’PICNAME” A SUBPICTURE OF THE PICTURE BEING 
GENERATED, THE PICTURE "PICNAME” MUST'EXJST AT THE TIME THIS CALL 
IS MADE, 

XIII.3, REPLACE 
»««»»«« 



FORTRAN! CALL REPLACE (PIC1.PJC2) 

LISP! (REPLACE (QUOTE PJCl) (QUOTE P.JC2)) 

THIS ROUTINE CAUSES ALL REFERENCES TO "PjCl” TO BE REPLACED 
BY REFERENCES TO "PIC2,*» THIS ROUTINE IS'USEFUL WHEN IT IS DESIRED 
TO CHANGE A SUBPICTURE WITHOUT REGENERATING ALL PICTURES OF WHICH IT IS 
A PART, 

XIII, 4, COMPIC 
****** 

FORTRANl CALL COMPIC (PJC) 

LISP I (COMPIC (QUOTE PIO) 

this call makes ”pjc m a component p.icture, 
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X I V • MISCELLANEOUS ROUTINES 

tttttttttttttttttttttt 

XIV, 1 SYNC AND NOSYNC 

»••*«««»«««#««« 

NORMALLY a flag is SET AT THE BEGINNING of THE DISPLAY FILE 
WHICH CAUSES THE DISPLAY PROCESSOR ALWAYS TO TAKE AN EVEN MULTIPLE OF 
1/60 SECOND TO DISPLAY THE DISPLAY FILE, THIS CAUSES UN JFORM~BRIGHTNESS 
TO BE MAINTAINED WHEN SHORT FILES ARE BEING DISPLAYED AND ACTS AS A 
FAILSAFE AGAINST BURNING A HOLE IN THE PHOSPHOR OF THE CRT SHOULD 
THE DISPLAY FILE CONSIST ONLY OF A SINGLE INTENSIFIED POINT, IF 
THE DISPLAY FILE Is LONG# HOWEVER# THIS "SYNCING" MAY RESULT IN 
FLICKER WHICH WOULD NOT OCCUR OF THE FLAG WERE NOT SET, ROUTINES HAVE 
BEEN PUT IN THE DISPLAY PACKAGE TO PERMIT USERS TO CONTROL THE STATE 
OF THIS FLAG, THESE ROUTINES SHOULD BE USED JUDICIOUSLY! 

TO SET THE "SYNC" BIT# 

FORTRAN! CALL SYNC 

LISP! (SYNC) , 

TO CLEAR THE "SYNC" BIT# 

FORTRAN! CALL NOSYNC 

LISP! { NOSYNC) , 

XIV, 2 DISEND 

FORTRAN! CALL DISEND 

LISP! (DISEND) 

THIS ROUTINE RELEASES THE DISPLAY AND ALLOWS THE JOB TO BE 
SWAPPABLE, THE DISPLAY CANNOT BE TURNED ON AGAIN WITHOUT REINITIALIZING 
THE ENTIRE PACKAGE, 



## XIV, 3 DISTRT 

## 

#« 

## FORTRAN! CALL DISTRT 
## 

## LISP! (DISTRT) 

## 

## THIS ROUTINE RESTARTS THE DISPLAY AFTER A CALL TO "DISEND", 

## THE APPEARANCE OF THE DISPLAY AND THE INTERNAL DATA STRUCTURES ARE 
## EXACTLY AS THEY WERE BEFORE "DISEND" WAS CALLED, 




XV, SPECIAL FORTRAN ROUTINES 
Mttfttttttttttttftttttf 

ROUTINES ARE AVAILABLE IN THE FORTRAN VERSION OF THE PACKAGE 
TO HANDLE TRO SPECIAL DISPLAY APPLICATIONS NOT AVAILABLE TO THE LISP USER, 

XV, 1 RASTER MODE 
««««»«»««*» 

A PATCH TO BE DISPLAYED IN RASTER MODE IS SPECIFIED BY GIVING THE 
PACKED GRAY-LEVEL BYTES IN AN ARRAY, THE GRAY-LEVEL BYTES MAY BE ONE, 

TWO, OR THREE BITS LONG, THE INTENSITIES CORRESPONDING TO THE SPECIFIED 



GRAY LEVELS ARE 


AS FOLLOWS! 


BYTE SIZE 






1 


2 


3 


gray level 








0 


0 


1 


0 


1 


7 


3 


i 


2 




5 


2 


3 




7 


3 


4 






4 


5 






5 


6 






6 


7 






7 


THE RASTER BYTES 


ARE GIVEN 


IN THE OROER 


OF A LEFT-TO-RIGHT, THEN 



TOP-TO-BOTTOM SCAN OF THE AREA, 

, THE RASTER-GENERATING ROUTINE IS INVOKED BY 

CALL RASTER <ARRAY#X0,Y0,X5IZE,YSI2EiCi I ,B) , 

WHERE 

ARRAY * NAME OF ARRAY CONTAINING GRAY-LEVEL BYTES 

X0iY0 * SCOPE COORDINATES OF UPPER-LEFT HAND CORNER OF RASTER PATCH 
XS 1 2E * YS 1 2E = NUMBER OF GRAY-LEVEL BYTES IN THE HOR 1 20NTAL AND 
VERTICAL DIRECTIONS IN THE PATCH 

C « 1 TO DISPLAY INTENSITY X FROM'THE TABLE AS INTENSITY 7-X ("COMPLEMENT”) 
0 TO DISPLAY NORMALLY 

I = 1 TO DISPLAY THE PATCH IN TWO INTERLEAVED PASSES THROUGH THE DATA 
0 TO DISPLAY NORMALLY 
B * BYTE SIZE OF THE BYTES IN "ARRAY," 

THE CLIPPING PROCESS COES NOT APPLY TO RASTER MODE DISPLAY. 
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xv . 2 three-dimensional display routines 
*#**##* **#**##*«*#***#**«** ******* 

ROUTINES ARE PROVIDED FOR PLOTTING CLIPPED* PARALLEL OR POINT 
PROJECTIONS OF POINTS AND LINES SPECIFIED BY THREE-DIMENSIONAL CARTESIAN COORDINATES, 
THE THREE-DIMENSIONAL TRANSLATION* ROTATION, AND PERSPECTIVE OF THE DATA 
IS GOVERNED BY A SINGLE 4X4 HOMOGENEOUS MATRIX WHICH SHOULD BE IN A COMMON 
AREA "T3" ESTABLISHED IN THE USER’S PROGRAM, 

IF NO ROTATION OR TRANSLATION IS IN EFFECT, THE "X" AND «Y” AXES OF 
THE USER’S THREE-DIMENSIONAL DATA WILL BE THE X ANO Y AXES OF THE USER’S 
DATA PAGE AS ESTABLISHED BY THE "SETWJND" ROUTINE, THE 2 AXIS WILL BE 
PERPENDICULAR TO tHE X AND Y AXES AND DIRECTED OUT OF THE SCOPE (RIGHT- 
HANDED SYSTEM), ROTATIONS ARE SPECIFIED BY PITCH (AROUND THE 2 AXIS), 

ROLL (AROUND THE Y AXIS), AND YAW (AROUND THE X AXIS), THAT IS, TO GET 
A DIFFERENT VIEW OF HIS DATA THE USER CHANGES NOT THE ACTUAL COORDINATES 

OF HIS data but the value of the matrix* then at generation TIME a different 
VIEW WILL be PRODUCED, 

TO SET UP THE MASTER (T3) MATRIX, THE USER SETS UP THE INDIVIDUAL 
MATRICES DESCRIBING THE TRANSLATION, ROTATIONS, AND PERSPECTIVE OF THE VIEW, 

THEN MULTIPLIES THEM TOGETHER. EACH OF THESE COMPONENT MATRICES IS A 

4X4 FORTRAN ARRAY i A COMPONENT MATRIX IS THEN SET UP BY CALLING A SUBROUTINE 

WITH THE NAME OF THE ARRAY, 

CALL TRANSL (X,Y,2,NAME) 

SETS UP A MATRIX TO MOVE THE ORIGIN TO <X,Y,2), 

CALL P ITCH ( X , NAME ) 

SETS UP A MATRIX JO PITCH THE DATA X QEGREES, 

CALL ROLL ( X » NAME ) 

SETS UP A MATRIX TO ROLL THE DATA X DEGREES, 

CALL YAW (X,NAME) 

SETS UP A MATRIX TO YAW THE DATA X DEGREES, 

CALL PERSP (X.NAME) 

SETS UP A MATRIX TO SHOW THE DATA IN POINT PERSPECTIVE, THE PROJECTION 
POINT WILL BE X IN FRONT OF THE 2*0 PLANE, AND THE PROJECTION PLANE 
WILL BE 2*0 . IF NO PERSPECTIVE IS SPECIFIED, PARALLEL PROJECTION IS 
ASSUMED. 




THE CALL 
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CALL MULM3 < N , XI , X2 , , t , , XN, X) 

MULTIPLIES THE N 4X4 MATRICIES XI ,.i XN TOGETHER AND STORES THE RESULT 
IN THE 4X4 MATRIX'X, THUS THE ESTABLISH THE MASTER TRANSFORMATION MATRIX, 
THE USER WOULD MULTIPLY HIS COMPONENT MATRICIES TOGETHER, IN THE DESIRED 
ORDER, AND STORE THE RESULT IN THE ARRAY IN THE T3 COMMON AREA, NOTE THAT 
A TRANSLATION following a rotation is different from the same translation 
preceding the rotation, the perspective transformation will normally 

BE THE LAST TO BE PERFORMED, 

THE GENERATING ROUTINES ARE 
CALL PGEN3 <X,Y,2,I) 

CALL VGEN3 ( OELTAX, DELTA Y#DELTA2, I ) 

WHICH ARE STRICTLY ANALOGOUS TO PGEN AND VGEN BUT IMPLICITLY USE THE T3 
MATRIX TO FORM THE PROJECTED VIEW, 

A USER MAY USE ANY OTHER SCHEME TO SET UP THE MASTER 
MATRIX, AND MAY THUS PRODUCE OTHER RESULTS (SHEARING, MAGNIFICATION, 

ETC,) , 
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xv. 2 three-dimensional display routines 

ROUTINES ARE PROVIDED FOR PLOTTING CLiPPEOi PARALLEL OR POINT 
PROJECTIONS OF POINTS AND LINES SPECIFIED BY THREE-DIMENSIONAL CARTESIAN COORDINATES, 
THE THREE-DIMENSIONAL TRANSLATION. ROTATION, AND PERSPECTIVE OF THE DATA 
IS GOVERNED BY A SINGLE 4X4 HOMOGENEOUS MATRIX WHICH SHOULD BE IN A COMMON 
AREA M T3 M ESTABLISHED IN THE USER’S PROGRAM, 

IF NO ROTATION OR TRANSLATION IS IN EFFECT, THE ”X” AND "Y" AXES OF 
THE USER'S THREE-DIMENSIONAL DATA WILL BE THE X AND Y AXES OF THE USER’S 
DATA PAGE AS ESTABLISHED BY THE ”SETW IND" ROUTINE. THE Z AXIS WILL BE 
PERPENDICULAR TO THE X AND Y AXES AND DIRECTED OUT OF THE SCOPE (RIGHT- 
HANDED SYSTEM), ROTATIONS ARE SPECIFIED BY PITCH (AROUND THE Z AXIS), 

ROLL (AROUND THE Y AXIS), AND YAW (AROUND THE X AXIS), THAT IS, TO GET 
A DIFFERENT VIEW OF HIS DATA THE USER CHANGES NOT THE ACTUAL COORDINATES 
OF HIS DATA BUT THE VALUE OF THE MATRIX! THEN AT GENERATION TIME A DIFFERENT 
VIEW WILL BE PRODUCED. 

TO SET UP THE MASTER <T3) MATRIX, THE USER SETS UP THE INDIVIDUAL 
MATRICES DESCRIBING THE TRANSLATION, ROTATIONS, AND PERSPECTIVE OF THE VIEW, 

THEN MULTIPLIES THEM TOGETHER, EACH OF THESE COMPONENT MATRICIES IS A 

4X4 FORTRAN ARRAY, A COMPONENT MATRIX IS THEN SET UP BY CALLING A SUBROUTINE 

WITH THE NAME OF THE ARRAY, 

CALL TRANSL (X,Y,Z,NAMf) 

SETS UP A MATRIX TO MOVE THE ORIGIN TO (X,Y,Z), 

CALL PITCH ( X , NAME ) 

SETS UP A MATRIX JO PITCH THE DATA X DEGREES, 

CALL ROLL ( X , NAME ) 

SETS UP A MATRIX TO ROLL THE DATA X DEGREES, 

CALL YAW (X,NAME) 

SETS UP A MATRIX TO YAW THE DATA X DEGREES, 

CALL PERSP ( X , NAME ) 

SETS UP A MATRIX TO SHOW THE DATA IN POINT PERSPECTIVE, THE PROJECTION 
POINT WILL BE X IN FRONT OF THE 2*0 PLANE, AND THE PROJECTION PLANE 
WILL BE 2*0 , IF NO PERSPECTIVE IS SPECIFIED, PARALLEL PROJECTION IS 
ASSUMED, 




THE CALL 
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CALL MULM3 <N»X1,X2, , t , ,XN,X) 

MULTIPLIES THE N 4X4 MATRICIES XI ,.t XN TOGETHER AND STORES THE RESULT 
IN THE 4X4 maTRIX'x, THUS THE ESTABLISH THE MASTER TRANSFORMATION MATRIX, 
THE USER WOULD MULTIPLY HIS COMPONENT MATRICIES TOGETHER, IN 1HI DESIRED 
ORDER, AND STORE THE RESULT IN THE ARRAY IN THE T3 COMMON AREA, NOTE THAT 
A TRANSLATION FOLLOWING A ROTATION IS DIFFERENT FROM THE SAME TRANSLATION 
PRECEDING THE ROTATION, THE PERSPECTIVE TRANSFORMATION WILL NORMALLY 
BE THE LAST TO BE PERFORMED, 

THE GENERATING ROUTINES ARE 

CALL PGEN3 <X,Y,2,I) 

CALL VGEN3 (QELTAX, DELTA Y»DELTA2, I ) 

WHICH ARE STRICTLY ANALOGOUS TO PGEN AND VGEN BUT IMPLICITLY USE THE T3 
MATRIX TO FORM THE PROJECTED VIEW, 

A USER MAY USE ANY OTHER SCHEME TO SET UP THE MASTER 
MATRIX, AND MAY THUS PRODUCE OTHER RESULTS (SHEARING, MAGNIFICATION, 

ETC,), 
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XV II I . ASSEMBLY and LOADING 

♦ tttttMtttttttttttt 

XVI 1 1 * 1 fortran 
»#•*««« 

## THE FORTRAN VERSIONS OF THE ROUTINES HAVE BEEN MADE INTO 

00 A LIBRARY WHICH IS PART OF THE FORTRAN SUBROUTINE LIBRARY, SINCE 

00 this library is normally searched each time a load occurs, the user 

00 NEED NO LONGER SPECIFY THE DISPLAY PACKAGE AS A MQOULE TO BE LOAOED 
00 EXPLICITLY^ SIMPLY REGARD the DISPLAY ROUTINES AS FORTRAN LIBRARY 

00 ROUTINES LIKE "SIN" AND "COS”, SINCE THE LIBRARY IS LOADED SELECTIVELY, DISPLAY PROGRAMS 
00 WILL BE SHORTER UNDER THE NEW LOADING MECHANISM THAN THE OLDER, 

00 

00 

00 THE STATEMENT "COMMON /T3/ NAME<4,4)" NEED APPEAR IN A USER’S 

00 PROGRAM ONLY IF HE IS USING THE THREE-DIMENSIONAL DISPLAY ROUTINES, 

XV 1 1 1, 2 LISP 

•••• 

TO ASSEMBLE THE DISPLAY PACKAGE FOR USE WITH LISP, INSERT THE 
STATEMENT 



FROM THE TELETYPE BEFORE ASSEMBLING DISCOM.MAC, !,E,I 
,R MACRO 

♦ DEV 1 01 SUSP, REL-TTY I , DEVI DISCOM.MAC 
L?0 

tZ 

END OF PASS 1 

♦ Z 

NO ERRORS DETECTED 

AS THE FIRST STEP IN CREATING A LISP DISPLAY IMAGE, 

THE FILE "DISLSP" SHOULD BE INPUT TO L.ISPI 

(INC (INPUT DEVI DISLSP)) 

THE REL FILE (DISLSP, RED MAY NOW BE LOADED, USING THE LISP LOADER, 

EITHER INTO BINARY PROGRAM SPACE OR INTO EXPANDED CORE, 

THE LISP DISPLAY PACKAGE IS NOW READY TO GO, THE "DISPINIT” ROUTINE 
MUST BE CALLED BEFORE ANY OTHER ROUTINE IN THE PACKAGE CAN BE REFERRED TO, 

XVIII, 3 assembly LANGUAGE 

•§•»«••>»»•««««•• 

THE ROUTINES MAY BE USED IN CONJUNCTION WITH ASSEMBLY CODE BY 
USING THE FORTRAN VERSION OF THE PACKAGE (DISCOM.REL) AND IMITATING 
THE FORTRAN COMPILER IN THE WAY IT CALLS SUBROUTINES. 




XIX, version-dependent features 

tttttttttttttttttftttttttt 

CERTAIN SYMBOLS ARE DECLARED EXTERNAL IN THE SOURCE OF THE DISPLAY 
PACKAGE. THEY ARE RECORDED HERE AS A MATTER OF RECORD IN CASE FORSC OR 
LISP CHANGES IN SUCH A WAY THAT LOADING CAUSES THESE SYMBOLS TO BE RESOLVED 

differently. 

XIX. 1 fortran 
«*«*»«« 

THE STATEMENTS 

EXTERN DEPOT, 



AND 

TYQLOC* XWD 0, DEPOT, "115 

APPEAR IN THE SOURCE FILE OISCOM.MAC, TYQLOC SHOULD CONTAIN, AFTER LOADING, 
THE ADDRESS LABELLED "CO” . IN FQRSE ("CO” IS NOT INTERNAL IN FORSE), 

SHOULD A NEW RELEASE OF FORSE BE AQUIRED, THE ’’FUDGE FACTOR” OF 
OCTAL -115 MAY HAVE TO BE ADJUSTED, 

XIX, 2 LISP 

THE STATEMENTS 

EXTERN TYO 



AND 



TYOLOCl EXP TYQ+50 

APPEAR IN THE SOURCE FILE DISCqM.MAC, TYQlOC WHoULD CONTAIN, AFTER LOADING, 
THE ADDRESS LABELLED "TTYO" IN LISP, THE ’’FUDGE FACTOR” OF OCTAL 50 
MAY HAVE TO ADJUSTED IN A NEW RELEASE OF LISP APPEARS, 
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XX, SAMPLE programs 

ttttttttftftttt 

XX, x fortran examples 
*#«•*«****#•#*** 

XX. 1.1 A PROGRAM TO SHOW A POINT TRACING THE BOUNDARY OF A CIRCLE, 

COMMON /T3/ DOG 

DIMENSION H(100),P1(3),P2<3) 

100 PORmaT(F) 

ACCEPT 100,EPSI J GOVERNS THE SPEED 

CALL DSPINI <H»100> 

CALL DCLPIC(P1,3) 

CALL OCLP IC ( PZ , 3 ) 

CALL SETWIN0<-1,1,*1,1) 

CALL SETPORT(0, 1023, 0,1023) 

X*0. 

Y«l. 

L*1 

K*. FALSE, 

1 GO TO ( 2 , 3 ) , l 

2 CALL GEN I N J (PI) 

GO TO A 

3 CALL GENJNMP2) 

4 CALL FARMS (1,7) 

CALL PGEN ( X , Y , 1 ) 

GO TO (5,6) , L 

5 CALL GENENO(Pl) 

IF ( K J CALL DESTROY < P2 ) 

K* . TRUE . 

GO TO 7 

6 CALL GENEND ( P2 ) 

CALL DESTROY ( Pi ) 

L a 3-L 

X«X+EPSI*Y 
Y s Y-EPS I *X 
GO TO 1 
END 



7 
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XX, 1.2 TO DISPLAY A TUMBLING CUBE WITH CORNERS LABELLED# IN PERSPECTIVE, 

COMMON /T3/ T<4,4> 

DIMENSION H(200>,P1<3),P2<3) 

DIMENSION YM<4,4) , PRM <4 , 4 ) , TM < 4 , 4 > #RM<4,4) »PM<4,4) 

500 FORMAT (’♦<'#li#»#» #11# *#»#U»'T») 

CALL OSPINI (H#200) 

CALL DCLPIC(P1,3) 

CALL DCLPIC(P2,3) 

CALL SETWIND(-l,3,-l,3j 
CALL SETPORT(0#1023#0#1023) 

CALL PERSP(1,PRM> 

CALL TRANSL(0»0#1#TM) 

Rs0. 

P*0 . 

Y*0 • 

L«1 

M«. FALSE, 

11 CALL ROLL<R»RM) 

CALL YAW(Y,YM) 

CALL P I TCH < P , PM ) 

CALL MULM3(5»PM#RM»YMiTM»PRM#TI 
GO TO <1#2)#L 

1 CALL GENINKPl) 

GO TO 3 

2 CALL CENINKP2). 

3 CALL PARMS(1,7) 

DO 4 I*0#1 

DO 4 J«0#1 

DO 4 K*0,1 

CALL PGEN3 (1,U,K,0) 

CALL TEXTP 
TYPE 500#IiJ,K 
CALL PGEN3(I,UiK#0> 

IF (I ,EQ, 1) GO TO 5 
CALL VGEN3U#0j0#1) 

CALL PGEN3(I#U#K,0) 

5 IF (J ,EO. 1) GO TO 6 
CALL VGEN3(C, 1,0,1) 

CALL PGEN3 ( I # U, K, 0 ) 

6 IF (K ,EO. 1) GO TO 4 
CALL VGEN3I0, 0,1,1) 

4 CONTINUE 

GO TO ( 7 , 8 ) » L 

7 CALL GENEND(Pl) 

IF (M> CALL DLSTROY ( P2 ) 

M*, TRUE, 

GO TO 9 

8 CALL GENEND ( P2 ) 

CALL DESTROY ( PI ) 

9 L*3-L 
R=R+1 • 
psp+2, 

Y*Y + 3. 

GO TO 11 
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XX, 2 LISP EXAMPLE 

THIS IS THE DEFINITION OF AN EXpR WHICH PUTS LISP OUTPUT ON THE 

display instead of the teletype, 

(DEFPROP 0 ((LAMBDA NIL (PROG (A QQ QQQ) 

(GENERATE QQ) 

A ( SETQ QQQ (EVAL (READ))) 

(DESTROY (QUOTE QQ)) 

(GENERATE QQ 

(PARMS 2 7) 

(SETWIN 0101) 

(SETPOR 0 1777 0 1777) 

(PGEN 0 .9 0) 

(TEXT QQQ)) 

(GO A>)) 



EX-PR) 
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appendix 

#*###### 

****** CATALOG OF FORTRAN DISPLAY ERRORS ****** 

WHEN A FATAL ERROR IS ENCOUNTERED BY THE DISPLAY PACKAGE* THE 
MESSAGE "DISPLAY ERROR NUMBER X" WILL BE TYPED ON THE USER’S 
TELETYPE and the teletype will BE RETURNED TO monitor level. 

BELOW IS A LIST OF THE ERRORS WHICH MAY OCCUR, 

ERRORS EXPLAINED AS "TYPE" ARE CAUSED AS FOLLOWS? ARGUMENTS TO THE 
ROUTINES IN THE DISPLAY PACKAGE ARE EITHER NAMES OF ARRAYS, 
FLOATING-POINT SINGLE PRECISION NUMBERS, OR FIXED POINT INTEGtRS, 

THE ROUTINES WILL CONVERT THE LAST TWO DATA TYPES TO EACH OTHER 
WHEN NECESSARY, BUT WILL NOT CONVERT OTHER TYPES (DOUBLE- 
PRECISION, ETC.). A "TYPE" ERROR IS CAUSED WHEN THE CONVERSION 
CANNOT BE PERFORMED. ALSO LISTED BEL0W FOR "TYPE" ERRORS IS THE 
NUMBER OF THE ARGUMENT IN THE ARGUMENT LIST, ANO THE TYPE TO WHICH 
THE CONVERSION IS TO BE MADE? THE SPEED WILL BE SOMEWHAT GREATER IF 
THE ARGUMENT IS GIVEN AS THE CORRECT DATA TYPE EVEN THOUGH THE 
CONVERSION FROM FLOATING TO FIXED OR VICE VERSA CAN BE PERFORMED, 



CERTAIN ROUTINES CAN BE CALLED ONLY DURING GENERATION? OTHERS 
ONLY OUTSIDE GENERATION, OTHERS (E,G, SETWIND) CAN BE CALLED AT 
ANY TIME, THE EXPLANATION "OUT OF PLACE" MEANS THAT A ROUTINE 
HAS BEEN CALLED INCORRECTLY WITH RESPECT TO THE "GENINI" ANO 
"GENEND" ROUTINES. 
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ERROR 

number ROUTINE EXPLANATION 



0 DSP I N I CANNOT INIT display, PROBABLY# the: DISPLAY has 
## OR YOUR JOB IS TOO LARGE TO FIT IN CORE TOGETHER 
## WITH SOME OTHER JOB ALREAOY RUNNING, 

BEEN ASSIGNED OR INIT ’ ED BY ANOTHER JOB, 



1 


DSP I N I 


TYPE 


2 


FIX 


2 


GENINl 


trying 


TO 


GENINl AN ALREADY EXISTING FRAME 


3 


«*«*«* 


NO MORE SPACE FOR DISPLAY FILE, THIS ERROR 
CAN OCCUR ANYWHERE IN THE GENERATING PROCESS, 

TO ESTIMATE THE SPACE NEEDED, ALLOW 1 WORD FOR 
EACH 2 SHORT VECTORS# 1 WORD FOR EACH 6 CHARACTERS 
l WORD FOR EACH POINT# 

AND 1 WORD FOR EACH 10 RASTER POINTS* THEN ADD 
ABOUT 10% FOR OVERHEAD, 


4 


vgen 


TYPE 


1 


FLOAT 


5 


vgen 


type 


2 


FLOAT 


6 


VGEN 


TYPE 


3 


FIX 


7 


PGEN 


TYPE 


1 


FLOAT 


8 


PGEN 


TYPE 


2 


FLOAT 


9 


PGEN 


TYPE 


3 


FIX 


10 


SETWIND 


type 


1 


FLOAT 


11 


SETWIND 


TYPE 


2 


FLOAT 


12 


SETWIND 


TYPE 


3 


FLOAT 


13 


SETWIND 


TYPE 


A 


FLOAT 


14 


SETPORT 


TYPE 


1 


FIX 


15 


SETPORT 


TYPE 


2 


FIX 


16 


SETPORT 


TYPE 


3 


FIX 


17 


SETPORT 


TYPE 


A 


FIX 


18 


FARMS 


TYPE 


1 


FIX 


19 


PARMS 


TYPE 


2 


FIX 


20 


FARMS 


INTENSITY 


IS NOT BETWEEN 0 AND 7 INCLUSIVE 


21 


PARMS 


scale 


IS NOT 1,2,4, OR 8 
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22 


SPICT 


NON- 


EXISTANT 


FRAME 


23 


blank 


NON- 


EXISTANT 


frame 


24 


unblank 


NUN- 


EXISTANT 


FRAME 


25 


destroy 


NON- 


EXISTANT 


frame 


26 


REPLACE 


NON- 


EXISTANT 


FRAME 


27 


raster 


T.ype 


2 


FIX 


28 


raster 


X INITIAL IS 


OUT OF RANGE 


29 


raster 


TYPE 


3 


FIX 


30 


RASTER 


Y INITIAL IS 


OUT OF RANGE 


31 


RASTER 


type 


4 


FIX 


32 


RASTER 


X SI2| < 0 




33 


RASTER 


type 


5 


FIX 


34 


raster 


Y SUE < 0 




35 


RASTER 


TYPE 


6 


FIX 


36 


raster 


type 


7 


FIX 


37 


RASTER 


type 


8 


FIX 


38 


RASTER 


BYTE 


SUE IS 


NOT 1,2, OR 3 


39 


raster 


WOULD GO OFF 


SCREEN HORIZONTALLY 


40 


RASTER 


WOULD GO OFF 


screen vertically 


41 


GEN3 


TYPE 


1 


FLOAT 


42 


GEN3 


TYPE 


2 


FLOAT 


43 


GEN3 


TYPE 


3 


FLOAT 


44 


GENS 


TYPE 


4 


FIX 


45 


MULM3 


TYPE 


1 


FIX 


46 


transl 


TYPE 


1 


FLOAT 


47 


transl 


TYPE 


2 


FLOAT 


48 


transl 


TYPE 


3 


FLOAT 


49 


pitch 


TYPE 


1 


FLOAT 



i" f* ii i LI 



T VDC 



C“ I r\ AT 




51 


ROLL 


TYPE 1 


28 

FLOAT 


52 


PERSP 


T^E 1 


FLOAT 


53 


sleep 


TYPE 1 


FIX 


54 


SETPORT 


X MIN < 0 OR X 


MIN > 1023 


55 


SETPORT 


X MAX < 0 OR X 


MAX > 1023 


56 


SETPORT 


Y MIN < 0 OR Y 


MIN > 1023 


57 


SETPORT 


Y MAX < 0 OR V 


MAX > 1023 


58 


SETWIND 


X MIN > OR s X 


MAX 


59 


SETWINO 


Y MIN > OR s Y 


MAX 


60 


SETPORT 


X MIN > OR a X 


MAX 


61 


SETPORT 


Y MIN > OR a Y 


MAX 


62 


SPJCT 


NON-EXISTANT PICTURE 


63 


- #*«*** 


TRYING TO CONVERT AN INTEGER > 2*26 TO 
FLOATING POINT 


64 


«««««« 


failure quring 


SETUWP UUO, SHOULD NOT OCCUR, 


65 


vgen 


OUT OF PLACE, 




66 


GEN I N I 


OUT OF PLACE, 




67 


PARMS 


OUT OF PLACE, 




68 


PGEN 


OUT OF PLACE, 




70 


genend 


OUT OF PLACE, 




71 


SPICT 


OUT OF PLACE, 




74 


oestroy 


OUT OF PLACE, 




75 


NOSYNC 


OUT OF PLACE* 




76 


SYNC 


OUT OF PLACE, 




77 


COMPIC 


OUT OF PLACE, 




78 


REPLACE 


OUT OF PLACE, 




79 


textp 


OUT OF PLACE, 




80 


LPON 


OUT OF PLACE, 




81 


LPOFF 


OUT OF PLACE, 




82 


f^ER 


OUT OF PLACE, 






catalog of lisp display errors 
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WHEN A FATAL ERROR IS ENCOUNTERED BY THE OISPLAY PACKAGE, THE 
MESSAGE "DISPLAY ERROR NUMBER X" WILL~BE TYPED ON THE USER’S 
TELETYPE AND THE TELETYPE WILL BE RETURNED TO TOP LEVEL, 

BELOW IS A LIST OF THE ERRORS WHICH MAY OCCUR, 




83 OISTRT SAME AS ERROR 0. 



••»»»•««»»«*«««*«« £ ft [) 




ERROR 

NUMBER ROUTINE EXPLANATION 
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0 


DSPINI 


CANNOT INIT DISPLAY, PROBABLY, THE DISPLAY 
BEEN ASSIGN’EO OR INIT^EO BY ANOTHER JOB, 


HAS 


3 


•••••• 


NO MORE SPACE FOR DISPLAY FILE, THIS ERROR 
CAN OCCUR ANYWHERE IN THE GENERATING PROCESS, 

TO ESTIMATE THE SPACE NEEDED, ALLOW 1 WORD FOR 
EACH 2 SHORT VECTORS, 1 WORD FOR EACH 6 CHARACTERS 
1 WORO FOR EACH POINT, 

AND 1 WORD FOR EACH 10 RASTER POINTS! THEN ADD 
ABOUT 10X FOR OVERHEAD, 


24 


PARMS 


INTENSITY IS NOT BETWEEN 0 AND 7 INCLUSIVE 




29 


PARMS 


SCALE IS NOT 1,2,4, OR 8 




66 


SETPORT 


X MIN < 0 OR X MIN > 1023 




67 


SETPORT 


X MAX < 0 OR X MAX > 1023 




70 


SETPORT 


Y MIN < 0 OR Y MIN > 1023 




71 


SETPORT 


Y MAX < 0 OR Y MAX > 1023 




72 


setwino 


X MIN > OR ■ X MAX 




73 


SETWINO 


Y MIN > OR « Y MAX 




74 


SETPORT 


X MIN > OR ■ X MAX 




79 


SETPORT 


Y MIN > OR « Y MAX 
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TRYING TO CONVERT AN INTEGER > 2t26 TO 
FLOATING POINT 





END 




BBN GKAPACQN! HARDWARE DESCRIPTION 



THE GRAF'ACON OR RAND TABLET IS A GRAPHICAL STYLUS INPUT DEVICE, 

IT CONSISTS OF A 10" BY 10” GRID OF 1024 8Y 1024 WIRES, THERE ARE 
THEREFORE 2t20 DISTINGUISHABLE POSITIONS ON THE'TABLET SURFACE, 

THESE POSITIONS ARE ASSIGNED COORDINATES IN THE SAME WAY AS COORDINATES 
ARE ASSIGNED TO THE RASTER POINTS OF f HE DEC 340 DISPLAY, WITH (0,0) 

IN THE LOWER LEFT-HAND CORNER/ (0,1777) IN THE~UPPER LEFT-HAND CORNER, 

ETC, SINCE THE PHYSICAL SI2E OF THE TABLET SURFACE IS APPROXIMATELY 
THE SAME AS THE SIZE OF THE ACTIVE SURFACE OF THE DISPLAY SCREEN, THE 

GRAFACON IS WELL SUITED FOR USE IN CONJUNCTION WITH THIS DISPLAY, 

THE STYLUS SERVES TWO LOGICALLY SEPARATE FUNCTIONS, FIRST, IT 
ACTS AS AN ANTENNA WHICH SENSES SIGNALS SENT THROUGH THE GRID WIRES 
AT REGULAR INTERVALS, THESE SIGNALS ARE DIFFERENT AT EVERY POSITION 
ON THE GRID, SO THAT I HE INFORMATION RECEIVED BY THE 
STYLUS CAN BE CONVERTED BY THE GRAFACON CONTROL INTO 
THE COORDINATES OF THE STYLUS OVER THE TABLET, SECOND, THE STYLUS 
HAS A MOVEABLE TIP CONTAINING A MICROSWITCH, THIS SWITCH JS NORMALLY 
OPEN BUT IS CLQSEU WHEN THE STYLUS IS PRESSED DOWN ON a SURFACE, 

CLOSING THE SWITCH CAUSES A F A JNTLY AUDIBLE CLICK, 

THE GRAFACON CONTROL SAMPLES COORDINATE DATA AT REGULAR 
INTERVALS QF APPROXIMATELY 220 MICROSECONDS, THIS PERIOD OF TIME WILL 
BE REFERRED TO AS ONE GRAFACON TICK, THE DATA MAY BE READ IN FROM THE 
GRAFACON COORDINATE BUFFER BY THE PQP"10 BY A DATAI 404 INSTRUCTION, 

FOR A PERIOD OF 40 MICROSECONDS OUT OF THE 220 MICROSECONDS, THE 
COORDINATE BUFFER IS CHANGING AND THE~DATAI ' WILL PRODUCE INACCURATE 
DATA, WHEN THE DATA IS READ IN IT IS MARKED WITH A "DATA READY” BIT TO 
INDICATE WHETHER OR NOT IT WAS READ DURING THE VALID 180 MICROSECONDS 
OF THE TICK. 

IF EITHER THE X OR Y COORDINATE CHANGES BY MORE THAN 1 BETWEEN 
TWO CONSECUTIVE SAMPLES AND THE PEN SWITCH IS CLOSED, THE ERROR BIT IS 

SET IN THE INPUT DATA, THIS INDICATES ONE OF THE FOLLOWING! 

1) THE PEN SWITCH IS CLOSED, BUT THE STYLUS IS NOT BEING HELD 
DOWN ON THE TABLET, 

2) THE PEN IS BEING MOVED TOO QUICKLY ACROSS THE TABLET, 

BELIEVE IT OR NOT, IT JS POSSIBLE TO MOVE THE PEN AT A RATE FASTER THAN 

45 INCHES PER SECOND, THE RATE AT WHICH MORE THAN ONE WIRE CAN BE CROSSED 
IN 220 MICROSECONDS, 

3) A GRAFACON MALFUNCTION) EITHER THE CONTROL LOGIC IS MALFUNCTIONING, 
OR, IF THE ERRORS OCCUR EVEN WHEN THE STYLUS IS NOT BEING PRESSED DOWN, 

THE PEN SWITCH IS BROKEN AND SHORTED CLOSED, 




grafacon <rand tablet) service routine 



i. introc^ion, 

A SERVICE ROUTINE (GFNSER) FOR THE BBN GRAFACON IS NOW 
PART OF THE MONITOR, THJS ROUTINE PERMITS THE RANO TABLET TO BE 
USED AS A STANDARD INPUT DEVICE UNDER THE 10/50 TIMESHARING 
MONITOR, AND ALSO PROVIDES FACILITIES FOR REAL-TIME 
MODIFICATION OF A DISPLAY FILE FOR THE 340 DISPLAY WHEN THE GRAFACON 
IS RUNNING, AS A STANDARD INPUT DEVICE, THE GRAFACON IS STARTED BY 
THE FIRST IN OR INPUT UUO, AND CONTINUES RUNNING UNTIL ALL ITS 
BUFFERS ARE FULL OR AN END-OF-FILE IS REACHED, 

II, SINGLE-STROKE AND MULTIPLE-STROKE DATA COLLECTION, 

THE SERVICE ROUTINE PROVIDES FOR TWO TYPES OF DATA COLLECTION 
"SINGLE-STROKE” AND "MULTIPLE-STROKE,” IN EACH CASE, DATA ARE 
COLLECTED ONLY WHEN THE PEN JS DOWN, IiE, WHEN THE PEN TIP SWITCH IS 
CLOSED, 



A. SINGLE-STROKE DATA COLLECTION 

IN "SINGLE-STKOKE" MODE, THE ROUTINE WAITS AFTER THE DEVICE 
HAS BEEN STARTED UNTIL THE PEN IS PRESSED DOWN, THEN COLLECTS DATA 
UNTIL THE PEN IS LIFTED UP I THE LIFTING OF THE PEN IS THE 

end-of-file condition, 

B, MULTIPLE-STROKE data collection 

IN "MULTIPLE-STROKE" MODE, THE ROUTINE WAITS AFTER THE 

device has been started until the pen is down, ano then starts to 

COLLECT DATA, THEREAFTER DATA ARE COLLECTED WHENEVER THE PEN" IS DOWN 
UNTIL'THE PEN HAS~BEEN UP (SWITCH OPEN) FOR A SPECIFIED LENGTH 
OF TIME, This "UPTIME COUNT” IS REINITIALIZED EACH TIME THE PEN 
GOES DOWN. IN THIS MODE, THE EXPIRATION OF THE UPTIME 
CONSTITUTES THE END-OF-FILE, A WORD OF ALL ONES («1) IS INSERTED 
AS A DATA ITEM IN THE INPUT BUFFER EACH TIME THE PEN IS LIFTED AS A 
SEPARATOR BETWEEN STROKES, 

IN EITHER CASE THE OEVICE MAY HAVE TO BE TEMPORARILY SHUT OFF 
IF ALL THE BUFFERS ARE FILLED, 




THE GRAFACON MAY PROOUCE TWO DIFFERENT KINOS OF INTERRUPTS, 
THEY ARE ON THE SAME INTERRUPT CHANNEL BUT MAY BE SEPARATELY ENABLED, 

FIRST# AN INTERRUPT MAY OCCUR WHEN NEW DATA HAS BEEN READ INTO 
THE GRAFACON COORDINATE BUFFER, SINCE 220 MICROSCECONDS IS MUCH 
FASTER THAN ONE NORMALLY wants TO SAMPLE DATA# THE INTERFACE IS 
EQUIPPED WITHA A COUNTER SO THAT ONLY EVERY N’TH OATA SAMPLE BY THE 
GRAFACON CONTROL WILL PRODUCE AN INTERRUPT TO THE PDP-10, HERE N IS 
AN INTEGER WHICH IS SPECIFIED BY A CONO 404 INSTRUCTION AND MAY BE 
BETWEEN X AND 400 OCTAL INCLUSIVE, THE RESULT IS THAT THE 
SAMPLING RATE MAY BE VARIED FORM A SAMPLE EVERY 220 MICROSECONDS 
TO A SAMPLE EVERY 56 MILLISECONDS, 

SECOND, AN INTERRUPT MAY OCCUR WHENEVER THE PEN SWITCH CHANGES 
STATUS (I, E. EITHER OPENS OR CLOSES), 




in. data modes 



TWO STANDARD data modes may be used with the grafacon! 

IMAGE (MODE 10 OCTAL) AND IMAGE 8 1 NARY (MODE 13 OCTAL). IN EACH 
CASE. THE BYTE SIZE IS 36 BITS, 

A. IMAGE MODE 

IN IMAGE MODE. DATA ARE COLLECTED EXACTLY AS PROVIDED BY THE 
DEVICE ( I ,E, BY A DATAI 404), 

B. IMAGE BINARY MODE 

IN IMAGE BINARY MODE. OATA ITEMS SUPPLIED BY THE GRAFACON 
IN WHICH THE "DATA READY” BIT (BIT 0) IS OFF OR THE ’’ERROR” BIT 
(BIT 1) IS ON ARE IGNORED AND DO NOT APPEAR ' IN THE INPUT BUFFER, 

THE ”GOOD” DATA WHICH DO APPEAR IN THE INPUT BUFFER ARE STRIPPED 
TO CONTAIN ONLY COORDINATE INFORMATION! 10 BITS OF Y RIGHT- 
JUSTIFIED IN THE LEFT HALF OF~THE WORD’aND 10‘BITS OF X RIGHT” 

JUSTIFIED IN THE RIGHT HALF OF THE WORD, ALL OTHER BITS ARE 0, 

IV. SPACING OF DATA, 

A. EQUAL-TIME 

THE USER MAY SPECIFY THE DATA SAMPLING RATE AS THE CONTENTS 
OF THE GRAFACON PRESET COUNTER, THAT IS, THE INTEGER N PROVIDED BY 
THE USER IS 1 LESS THAN THE NUMBER OF SRAFACON TICKS BETWEEN DATA SAMPLES 
(1 GRAFACON TICK 8 220 MICROSECONDS), 

B. EQUAL-SPACE 

THE USER MAY ALSO SPECIFY THAT THE DATA BE THINNEO BY THE 
SERVICE ROUTINE, I.E, A POINT WILL APPEAR IN THE INPUT 
BUFFER ONLY IF IT IS AT A distance OF‘AT leastn IN EITHER X OR Y 
FROM THE PREVIOUS POINT IN THE BUFFER (EXCEPT FOR THE FIRST POJNT 
OF A STROKE, WHICH ALWAYS WILL APPEAR IN THE BUFFER), 

IN THIS CASE THE ”N" SUPPLIED BY THE USER” WILL BE USED BOTH AS THE 
DATA SAMPLING RATE ANO AS THE SPACING PARAMETER, 

TO PREVENT UNNECESSARILY FREQUENT INTERRUPTS BY THE 
GRAFACON, THE SERVICE ROUTINE RESTRICTS N TO BE GREATER THAN OR EQUAL 
TO 5, 




V, TRACKING. 



’’TRACKING” IS THE FIRST WAY IN WHICH THE GRAFACON 
SERVICE ROUTINE HAY MODIFY A USER’S DISPLAY FILE WHILE THE GRAFACON 
IS RUNNING, THE USER HAY SUPPLY AN ADDRESS IN HIS JOB AREA TO BE 
USED AS THE ’’TRACKING ADDRESS, •' AT INTERRUPT LEVEL. THE SERVICE ROUTINE 
WOULD PLACE THE GRAFACON Y COORDINATE IN BITS B-17 OF THIS 
LOCATION, AND THE X COORDINATE IN BITS 26*35, THIS OPERATION WOULD 
OCCUR WHETHER THE PEN IS UP OR DOWN, TYPICALLY, THIS ADDRESS WOULD CONTAIN 
A POINT MODE WORD AND WOULD BE PART OF A DISPLAY FILE, THE RESULT 
IS THE GRAFACON ANALOGUE OF LlGHT-PEN TRACKING, 

VI, INKING, 



THE SERVICE ROUTINE WILL ALSO PERFORM "INKING” WHILE THE 
GRAFACON IS RUNNING IF REQUESTED AND A LEGAL INKING BUFFER IS 
SPECIFIED By THE USER7 "INK" IS A DISPLAY SUBROUTINE WHICH 



SHOWS THE TRAJECTORY OF THE PEN ON THE TABLET WHEN THE PEN IS 
DOWN, THE USER SUPPLIED THE BEGINNING AND ENDING ADDRESSES 
OF THE INK BUFFER! THE SERVICE ROUTINE WILL INITIALIZE, MODIFY, AND 
CLEAR THE INK BUFFER ON COMMAND, IT IS THE USER’S RESPONSIBILITY 
TO INSERT A CALL TO THE INK BUFFER IN HIS QISPLAY FILE AS A 
"DJS INK VTR," THE RETURN WOULD BE IN PARAMETER MODE, 



IF THE INK BUFFER IS FILLEO, INKING WILL STOP, BUT 
THE DEVICE WILL NOT BE SHUT OFF AND DAJA COLLECTION WILL 
CONTINUE. 




B. USETO 



USETO D * E 

£* XWO INKBEG, INKEND 

XWD trkadr#rate 

EXP UPTIME 

THE USETO UUO IS USED TO PASS PARAMETERS TO THE SERVICE ROUTINE, 
E SHOULD CONTAIN THE ADDRESSES OF THE FIRST AND LAST LOCATIONS OF THE 
INK BUFFER# IF DESIREOl 0 OTHERWISE, E*1 (LEFT HALF) SHOULD CONTAIN 
THE TRACKING ADDRESS# IF ANY) 0 OTHERWISE, EH (RIGHT HALE ) SHOULD 
CONTAIN THE DATA RATE (OR DATA SPACING) AS AN INTEGER ' BETWEEn'5 ANO 377 
OCTAL INCLUSIVE. £♦ 2 SHOULD CONTAIN THE UPTIME PARAMETER IN 
GRAFACON TICKS, THE MAXIMUM PERMISSABLE UPTIME IS 40000 DECIMAL 
TICKS (APPROXIMATELY 10 SECONDS), 

SPECIAL CASES* 



1) IF INKING IS SPECIFIED ANO THE CONTENTS OF E IS 0, 

NO ERROR CONDITION RESULTS BUT INKING WILL NOT OCCUR, 

2) IF THE CONTENTS OF E IS NONZERO BUT 

A) INKBEG OR INKEND IS LESS THAN 20 OCTAL OR 
OUTSIDE THE USER'S'jQB AREA 
OR B) INKENO < INKBEG*4 

THEN AN ERROR MESSAGE WILL BE TYPED ON THE USER’S TELETYPE 
AND HIS JOB WILL BE PUT IN AN ERROR STOP STATE, 

3) IF TRACKING IS SPECIFIED AND THE CONTENTS OF EH (LEFT HALF) IS 0, NO 
ERROR RESULTS BUT TRACKING WILL NOT OCCUR, 

4) IF THE CONTENTS OF EH (LEFT HALF) IS NONZERO BUT IS LESS 
THAN 20 OCTAL OR OUTSIDE THE USER’S JOB AREA# THEN AN ERROR 
MESSAGE WILL BE TYPED ON THE 0§ER»S TELETYPE AND HIS 

JOB PUT IN AN ERROR STOP STATE, 

5) IF THE CONTENTS OF EH (RIGHT HALF) IS 0# THE MAXIMUM DATA 
SPACING (377 OCTAL) WILL BE USED, 

6) IF THE CONTENTS OF EH (RIGHT HALF) IS 1# 2# 3# OR 4, THEN 
5 WILL BE USED AS THE DATA SPACING, 

7) IF THE CONTENTS OF E+l (RIGHT HALF) IS GREATER THAN 377 
OCTAL* THAN ONLY THE RIGHTMOST 6 BITSWILL BE USED BY " f HE 
SERVICE ROUTINE AND COMMENTS 5 AND 6 WILL APPLY, 

8) IF THE CONTENTS OF EH IS NEGATIVE OR GREATER THAN OR 

EQUAL TO 40000 DECIMAL, 0 WILL BE USED AS THE UPTIME PARAMETER, 

9) IF NO USETO AT ALL IS PERFORMED, THE EFFECT IS THE SAME AS IF 

THE USETO WERE PERFORMED BUT ALL THREE WORDS E,E*1# AND E+2 WERE 0 , 

10) IF AN INK BUFFER ALREADY EXISTS WHEN THE USETO IS PERFORMED# IT 




C. IN D# AND INPUT D * 

THESE UUD1S ARE COMPLETELY STANDARD, 

D. CLOSE D» 

THE CLOSE DUO IS COMPLETELY STANDARD, IT CLEARS THE 

end-of-file FLAG SO that another input CAN BE performed, 

IF THERE IS AN INK BUFFER WHEN THE CLOSE IS PERFORMED* IT 
IS CLEARED (THE INK IS ERASED), 

E. RELEAS D, 

THIS UUO IS COMPLETELY STANDARD, 

F. EXAMPLE 

A "NORMAL" SEQUENCE OF UUO’S FOR THE GRAFACON 
MIGHT BE AS FOLLOWS l INIT, USETO, INBUF# INPUT# INPUT* .,,* INPUT 
CLOSE# INPUT# «<.' 
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